﻿<html DIR="LTR" xmlns:tool="http://www.microsoft.com/tooltip" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:ddue="http://ddue.schemas.microsoft.com/authoring/2003/5" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
  <head>
    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=utf-8" />
    <META NAME="save" CONTENT="history" />
    <title>Construindo a URL de conexão</title>
    
    <link rel="stylesheet" type="text/css" href="../local/Classic.css">
      
    </link>
    
    <script src="../local/script.js">
      
    </script><script src="../local/script_main.js">&amp;nbsp;</script>
  </head>
  <body>
    <!--Topic built:04/01/2010 05:03:30-->

    
    
    
    
    
    
    
    
    
    <div id="header">
      <table width="100%" id="topTable"><tr>
          <td align="left">
            <span id="headerBold">Construindo a URL de conexão</span>
          </td>
          <td align="right">
            
          </td>
        </tr></table>
      
      
      
    </div>
    <div id="mainSection">
      
        
        
    <font color="DarkGray">
      
    </font>
    <p />
    
    <p />
  
        <div id="introductionSection" class="section">
    <p>O formato geral da URL de conexão é</p>
    <p>
      <code>jdbc:sqlserver://[serverName[\instanceName][:portNumber]][;property=value[;property=value]]</code>
    </p>
    <p>onde: </p>
    <ul><li>
        
          <b>jdbc:sqlserver://</b> (Necessário) é conhecido como o subprotocolo e é constante. <br />
      </li><li>
        
          <b>serverName</b> (Opcional) é o endereço do servidor com o qual será feita a conexão. Pode ser um endereço IP ou DNS, ou pode ser localhost ou 127.0.0.1 para o computador local. Se não for especificado na URL de conexão, o nome do servidor deverá ser especificado na coleção de propriedades.<br />
      </li><li>
        
          <b>instanceName</b> (Opcional) é a instância com a qual será feita a conexão em serverName. Se não for especificada, será feita uma conexão com a instância padrão.<br />
      </li><li>
        
          <b>portNumber</b> (Opcional) é a porta com a qual será feita a conexão em serverName. O padrão é 1433. Se estiver usando o padrão, você não precisará especificar a porta, nem os dois-pontos (':') que a precedem, na URL.<br />
        <div style="margin: .5em 1.5em .5em 1.5em"><b>Observação: </b>
          Para um desempenho de conexão ideal, recomenda-se definir o portNumber ao se estabelecer conexão com uma instância nomeada. Isso evitará uma viagem de ida e volta ao servidor para determinar o número da porta. Se forem usados um portNumber e um instanceName, o portNumber terá precedência e o instanceName será ignorado.<p />
        </div>
      </li><li>
        
          <b>property</b> (Opcional) é uma ou mais propriedades de conexão de opção. Para obter mais informações, consulte <a href="f1b62700-f046-488d-bd6b-a5cd8fc345b7.htm">Definindo as propriedades de conexão</a>. Qualquer propriedade da lista pode ser especificada. As propriedades só podem ser delimitadas com o uso de ponto-e-vírgula (';') e não podem ser duplicadas. <br />
      </li></ul>
    <div style="margin: .5em 1.5em .5em 1.5em"><b>Cuidado: </b>
      Para fins de segurança, recomenda-se evitar construir as URLs de conexão com base na entrada do usuário. Convém especificar apenas o nome do servidor e o driver na URL. Para os valores de nome de usuário e senha, use as coleções de propriedades de conexão. Para obter mais informações sobre segurança nos aplicativos JDBC, consulte <a href="90724ec6-a9cb-43ef-903e-793f89410bc0.htm">Protegendo aplicativos do JDBC Driver</a>.<p />
    </div>
  </div><h1 class="heading">Exemplos de conexão</h1><div id="sectionSection0" class="section"><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      <p xmlns="">Conectar ao banco de dados padrão no computador local usando um nome de usuário e senha:</p>
      <p xmlns="">
        <code>jdbc:sqlserver://localhost;user=MyUserName;password=*****;</code>
      </p>
      <div style="margin: .5em 1.5em .5em 1.5em" xmlns=""><b>Observação: </b>
        Embora o exemplo anterior utilize um nome de usuário e senha na cadeia de conexão, se o aplicativo estiver sendo executado em um sistema operacional Windows, recomenda-se usar a segurança integrada, que oferece mais proteção. Para obter mais informações, consulte a seção <a href="#Connectingintegrated">Conectando com a autenticação integrada</a>, mais adiante neste tópico.<p />
      </div>
      <p xmlns="">Conectar ao banco de dados padrão no computador local usando a autenticação integrada:</p>
      <p xmlns="">
        <code>jdbc:sqlserver://localhost;integratedSecurity=true;</code>
      </p>
      <p xmlns="">Conectar a um banco de dados nomeado em um servidor remoto:</p>
      <p xmlns="">
        <code>jdbc:sqlserver://localhost;databaseName=AdventureWorks;integratedSecurity=true;</code>
      </p>
      <p xmlns="">Conectar na porta padrão ao servidor remoto:</p>
      <p xmlns="">
        <code>jdbc:sqlserver://localhost:1433;databaseName=AdventureWorks;integratedSecurity=true;</code>
      </p>
      <p xmlns="">Conectar especificando um nome de aplicativo personalizado:</p>
      <p xmlns="">
        <code>jdbc:sqlserver://localhost;databaseName=AdventureWorks;integratedSecurity=true;applicationName=MyApp;</code>
      </p>
    </content></div><h1 class="heading">Instâncias nomeadas e várias instâncias do SQL Server</h1><div id="sectionSection1" class="section"><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      <p xmlns="">
        O SQL Server permite a instalação de várias instâncias de banco de dados por servidor. Cada instância é identificada por um nome específico. Para conectar a uma instância nomeada do SQL Server, você pode especificar o número de porta da instância nomeada (preferencial) ou pode especificar o nome da instância como uma propriedade URL do JDBC ou uma propriedade <b>datasource</b>. Se nenhuma propriedade de nome de instância ou número de porta for especificada, será criada uma conexão com a instância padrão. Veja os exemplos a seguir:</p>
      <p xmlns="">Para usar um número de porta, faça o seguinte:</p>
      <p xmlns="">
        <code>jdbc:sqlserver://localhost:1433;integratedSecurity=true;&lt;more properties as required&gt;;</code>
      </p>
      <p xmlns="">Para usar uma propriedade URL do JDBC, faça o seguinte:</p>
      <p xmlns="">
        <code>jdbc:sqlserver://localhost;instanceName=instance1;integratedSecurity=true;&lt;more properties as required&gt;;</code>
      </p>
    </content></div><h1 class="heading">Escapando valores na URL de conexão</h1><div id="sectionSection2" class="section"><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      <p xmlns="">Pode ser necessário escapar certas partes dos valores da URL de conexão devido à inclusão de caracteres especiais como espaços, ponto-e-vírgulas e aspas. O driver JDBC dará suporte ao escape desses caracteres se eles estiverem entre chaves. Por exemplo, {;} escapa um ponto-e-vírgula.</p>
      <p xmlns="">Os valores escapados podem conter caracteres especiais (principalmente '=', ';', '[]' e espaço), mas não podem conter chaves. Convém adicionar os valores que devem ser escapados e contêm chaves a uma coleção de propriedades.</p>
      <div style="margin: .5em 1.5em .5em 1.5em" xmlns=""><b>Observação: </b>
        O espaço em branco dentro das chaves é literal e não é cortado.<p />
      </div>
    </content></div><a name="Connectingintegrated"> </a><h1 class="heading">Conectando com a autenticação integrada</h1><div id="sectionSection3" class="section"><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      <p xmlns="">O driver JDBC dá suporte ao uso da autenticação integrada do Tipo 2 em sistemas operacionais Windows por meio da propriedade de cadeia de conexão integratedSecurity. Para usar a autenticação integrada, copie o arquivo sqljdbc_auth.dll para um diretório no caminho do sistema Windows no computador em que o driver JDBC está instalado. </p>
      <p xmlns="">Os arquivos sqljdbc_auth.dll estão instalados no seguinte local:</p>
      <p xmlns="">&lt;<i>diretório de instalação</i>&gt;\sqljdbc_&lt;<i>versão</i>&gt;\&lt;<i>idioma</i>&gt;\auth\</p>
      <div style="margin: .5em 1.5em .5em 1.5em" xmlns=""><b>Observação: </b>
        Se você estiver executando uma Máquina Virtual Java (JVM) de 32 bits, use o arquivo sqljdbc_auth.dll na pasta x86, mesmo se o sistema operacional for a versão x64. Se estiver executando uma JVM de 64 bits em um processador x64, use o arquivo sqljdbc_auth.dll na pasta x64. Se estiver executando uma JVM de 64 bits em um processador Itanium, use o arquivo sqljdbc_auth.dll na pasta IA64.<p />
      </div>
      <p xmlns="">Como alternativa, você pode definir a propriedade do sistema java.libary.path para especificar o diretório de sqljdbc_auth.dll. Por exemplo, se o driver JDBC for instalado no diretório padrão, você poderá especificar o local da DLL usando o seguinte argumento de máquina virtual (VM) quando o aplicativo Java for iniciado: </p>
      <p xmlns="">
        <code>-Djava.library.path=C:\Microsoft SQL Server JDBC Driver\sqljdbc_&lt;version&gt;\enu\auth\x86</code>
      </p>
      <div style="margin: .5em 1.5em .5em 1.5em" xmlns=""><b>Observação: </b>
        O driver JDBC não dá suporte à autenticação integrada quando é executado em sistemas operacionais que não são Windows. O driver também não oferece funcionalidade para fornecer credenciais de Autenticação do Windows, como nome de usuário e senha, quando se estabelece conexão com o SQL Server a partir de sistemas operacionais que não são Windows. Nesses casos, os aplicativos devem usar a Autenticação do SQL Server.<p />
      </div>
    </content></div><h1 class="heading">Conectando com endereços IPv6</h1><div id="sectionSection4" class="section"><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      <p xmlns="">O JDBC Driver oferece suporte ao uso de endereços IPv6 com a coleção de propriedades de conexão e com a propriedade de cadeia de conexão serverName. O valor de serverName inicial, como jdbc:<i>sqlserver</i>://<i>serverName</i>, não tem suporte para endereços IPv6 em cadeias de conexão. Usar um nome para <i>serverName</i> em vez de um endereço IPv6 bruto funcionará em todos os casos na conexão. Os exemplos a seguir fornecem mais informações.</p>
      <p xmlns="">
        <b>Para usar a propriedade serverName</b>
      </p>
      <p xmlns="">
        <code>jdbc:sqlserver://;serverName=3ffe:8311:eeee:f70f:0:5eae:10.203.31.9\\instance1;integratedSecurity=true;</code>
      </p>
      <p xmlns="">
        <b>Para usar a coleção de propriedades</b>
      </p>
      <p xmlns="">
        <code>Properties pro = new Properties();</code>
      </p>
      <p xmlns="">
        <code>pro.setProperty("serverName", "serverName=3ffe:8311:eeee:f70f:0:5eae:10.203.31.9\\instance1");</code>
      </p>
      <p xmlns="">
        <code>Connection con = DriverManager.getConnection("jdbc:sqlserver://;integratedSecurity=true;", pro);</code>
      </p>
    </content></div><span id="seeAlsoSpan"><h1 class="heading">Consulte também</h1></span><div id="seeAlsoSection" class="section" name="collapseableSection"><a href="94bcfbe3-f00e-4774-bda8-bb7577518fec.htm">Conectando ao SQL Server com o JDBC Driver</a><br /><br /></div><!--[if gte IE 5]>
			<tool:tip element="seeAlsoToolTip" avoidmouse="false"/><tool:tip element="languageFilterToolTip" avoidmouse="false"/><tool:tip element="roleInfoSpan" avoidmouse="false"/>
		<![endif]-->
      <div id="footer" class="section">
        
		<hr />
		
		<span id="fb" class="feedbackcss">
			
			
		</span>
		
		<a href="9bad553b-9e70-4696-8499-2e35f772a1e0.htm">
			
			© 2010 Microsoft Corporation. Todos os direitos reservados.
		</a>
 	
	
      </div>
    </div>
  </body>
</html>